feat(jcache): [Cache Tracing 5] Add SentryJCacheWrapper for JCache (JSR-107) by adinauer · Pull Request #5179 · getsentry/sentry-java

adinauer · 2026-03-09T15:24:25Z

PR Stack (Cache Tracing)

#5172 — Add SentryCacheWrapper and SentryCacheManagerWrapper
#5173 — Add enableCacheTracing option
#5174 — Add BeanPostProcessor and auto-configuration
#5175 — Add cache tracing e2e sample
#5179 — Add SentryJCacheWrapper for JCache (JSR-107)
#5182 — Add JCache console sample
#5183 — Add cache tracing to all Spring Boot 4 samples
#5184 — Add retrieve() overrides for reactive/async cache support
#5190 — Port cache tracing to Spring Boot 3 Jakarta + samples
#5191 — Port cache tracing to Spring Boot 2 + samples

📜 Description

Adds a new sentry-jcache module that provides cache tracing for apps using the JCache (JSR-107) API. SentryJCacheWrapper<K,V> implements javax.cache.Cache<K,V> and creates Sentry spans for cache operations:

cache.get — get, getAll, invoke, invokeAll
cache.put — put, getAndPut, putAll, replace, getAndReplace
cache.remove — remove, getAndRemove, removeAll
cache.flush — clear
Passthrough (no spans) — putIfAbsent, containsKey, close, loadAll, metadata methods, listener registration, iterator

Sets cache.hit, cache.key span attributes via SpanDataConvention. Gated on isEnableCacheTracing(). Trace origin: auto.cache.jcache.

💡 Motivation and Context

Spring Cache covers Spring users, but many Java apps use JCache directly (plain Java, Micronaut, CDI/Jakarta EE). This module provides the same cache tracing experience for those users. JCache never migrated to Jakarta namespace, so javax.cache works everywhere.

💚 How did you test it?

32 unit tests covering all instrumented methods, hit/miss detection, passthrough operations, error handling, and option gating.

📝 Checklist

I added GH Issue ID & Linear ID
I added tests to verify the changes.
No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled.
I updated the docs if needed.
I updated the wizard if needed.
Review from the native team if needed.
No breaking change or entry added to the changelog.
No breaking change for hybrid SDKs or communicated to hybrid SDKs.

🔮 Next steps

Console sample showcasing manual JCache usage
Port cache classes to sentry-spring-jakarta and sentry-spring

⚠️ Merge this PR using a merge commit (not squash). Only the collection branch is squash-merged into main.

github-actions · 2026-03-09T15:24:59Z

Semver Impact of This PR

🟡 Minor (new features)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).

New Features ✨

Core

[Cache Tracing 2] Add enableCacheTracing option by adinauer in #5173
[Cache Tracing 2] Add enableCacheTracing option by adinauer in #5163

Spring

[Cache Tracing 1] Add SentryCacheWrapper and SentryCacheManagerWrapper by adinauer in #5172
[Cache Tracing 3] Add BeanPostProcessor and auto-configuration by adinauer in #5174
[Cache Tracing 3] Add BeanPostProcessor and auto-configuration by adinauer in #5164
[Cache Tracing 1] Add SentryCacheWrapper and SentryCacheManagerWrapper by adinauer in #5162
[Cache Tracing 1] Add SentryCacheWrapper and SentryCacheManagerWrapper by adinauer in #5137

Other

(anr) Profile main thread when ANR and report ANR profiles to Sentry by markushi in #4899

(jcache) [Cache Tracing 5] Add SentryJCacheWrapper for JCache (JSR-107) by adinauer in #5179

Bug Fixes 🐛

Remove the dependency on protobuf-lite for tombstones by supervacuus in #5157

_{🤖 This preview updates automatically when you update the PR.}

github-actions · 2026-03-09T15:25:06Z

	Messages
📖	Do not forget to update Sentry-docs with your feature once the pull request gets approved.

Generated by 🚫 dangerJS against bbbb702

sentry · 2026-03-09T15:33:03Z

Sentry Build Distribution

App	Version	Configuration
SDK Size	8.34.1 (1)	release

github-actions · 2026-03-09T15:46:24Z

Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	405.46 ms	514.34 ms	108.88 ms
Size	0 B	0 B	0 B

Baseline results on branch: feat/cache-tracing-sample

Startup times

Revision	Plain	With Sentry	Diff
`0ceb700`	305.81 ms	355.91 ms	50.10 ms
`855766f`	364.82 ms	427.16 ms	62.35 ms
`eeb463c`	311.36 ms	371.79 ms	60.43 ms
`b2b863f`	338.62 ms	376.54 ms	37.92 ms

App size

Revision	Plain	With Sentry	Diff
`0ceb700`	0 B	0 B	0 B
`855766f`	0 B	0 B	0 B
`eeb463c`	0 B	0 B	0 B
`b2b863f`	0 B	0 B	0 B

Previous results on branch: feat/cache-tracing-jcache

Startup times

Revision	Plain	With Sentry	Diff
`bff862e`	315.13 ms	364.41 ms	49.28 ms
`10c6fa4`	308.73 ms	384.38 ms	75.66 ms
`290c35b`	320.64 ms	355.09 ms	34.45 ms
`c3caf85`	313.96 ms	352.98 ms	39.02 ms

App size

Revision	Plain	With Sentry	Diff
`bff862e`	0 B	0 B	0 B
`10c6fa4`	0 B	0 B	0 B
`290c35b`	0 B	0 B	0 B
`c3caf85`	0 B	0 B	0 B

Like putIfAbsent, these are conditional writes that may be no-ops. Emitting a cache.put span for them would be misleading.

sentry · 2026-03-10T05:11:58Z

Sentry Build Distribution

App	Version	Configuration
SDK Size	8.34.1 (1)	release

startChild can return a NoOp span (e.g. when span limit is reached). Skip instrumentation in that case to avoid unnecessary work.

sentry · 2026-03-10T05:22:38Z

Sentry Build Distribution

App	Version	Configuration
SDK Size	8.34.1 (1)	release

removeAll() with no args removes all entries, which is semantically equivalent to clear(). Use cache.flush instead of cache.remove. The keyed removeAll(Set) remains cache.remove.

sentry · 2026-03-10T05:30:45Z

Sentry Build Distribution

App	Version	Configuration
SDK Size	8.34.1 (1)	release

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

sentry · 2026-03-10T12:08:40Z

Sentry Build Distribution

App	Version	Configuration
SDK Size	8.34.1 (1)	release

sentry · 2026-03-10T12:49:35Z

Sentry Build Distribution

App	Version	Configuration
SDK Size	8.34.1 (1)	release

sentry · 2026-03-10T13:14:39Z

Sentry Build Distribution

App	Version	Configuration
SDK Size	8.34.1 (1)	release

adinauer · 2026-03-10T14:30:22Z

cursor review

adinauer · 2026-03-10T14:30:29Z

@sentry review

adinauer · 2026-03-10T14:31:36Z

@sentry review

adinauer · 2026-03-10T14:31:42Z

cursor review

cursor

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

sentry-jcache/src/main/java/io/sentry/jcache/SentryJCacheWrapper.java

sentry · 2026-03-10T14:52:57Z

Sentry Build Distribution

App	Version	Configuration
SDK Size	8.34.1 (1)	release

lbloder · 2026-03-16T08:17:40Z

sentry-jcache/README.md

+- [Apache Ignite](https://ignite.apache.org/)
+- [Infinispan](https://infinispan.org/)
+
+Please consult the documentation on how to install and use this integration in the Sentry Docs for [Java](https://docs.sentry.io/platforms/java/tracing/instrumentation/jcache/).


Is this going to be the final url for the jcache docs? We need to make sure to update this if needed

Let's confirm before merging the PR

feat(jcache): Add SentryJCacheWrapper for JCache (JSR-107) cache tracing

6822d8a

changelog

4b6759d

fix(jcache): Make replace and getAndReplace passthrough (no span)

93be5c8

Like putIfAbsent, these are conditional writes that may be no-ops. Emitting a cache.put span for them would be misleading.

fix(jcache): Check for NoOp span after startChild

038e792

startChild can return a NoOp span (e.g. when span limit is reached). Skip instrumentation in that case to avoid unnecessary work.

fix(jcache): Use cache.flush for removeAll() without keys

0d4de4b

removeAll() with no args removes all entries, which is semantically equivalent to clear(). Use cache.flush instead of cache.remove. The keyed removeAll(Set) remains cache.remove.

adinauer mentioned this pull request Mar 10, 2026

feat(samples): [Cache Tracing 6] Add JCache console sample #5182

Open

8 tasks

adinauer and others added 2 commits March 10, 2026 13:04

Merge branch 'feat/cache-tracing-sample' into feat/cache-tracing-jcache

ebb8ee1

changelog

7453d68

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Merge branch 'feat/cache-tracing-sample' into feat/cache-tracing-jcache

ba9add7

adinauer added 2 commits March 10, 2026 13:50

changelog

032ab26

Merge branch 'feat/cache-tracing-sample' into feat/cache-tracing-jcache

bbbb702

adinauer mentioned this pull request Mar 10, 2026

feat(samples): [Cache Tracing 7] Add cache tracing to all Spring Boot 4 samples #5183

Open

8 tasks

adinauer marked this pull request as ready for review March 10, 2026 13:57

adinauer requested review from markushi and romtsn as code owners March 10, 2026 13:57

cursor bot reviewed Mar 10, 2026

View reviewed changes

sentry-jcache/src/main/java/io/sentry/jcache/SentryJCacheWrapper.java Show resolved Hide resolved

lbloder reviewed Mar 16, 2026

View reviewed changes

lbloder approved these changes Mar 16, 2026

View reviewed changes

Uh oh!

Conversation

adinauer commented Mar 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR Stack (Cache Tracing)

📜 Description

💡 Motivation and Context

💚 How did you test it?

📝 Checklist

🔮 Next steps

Uh oh!

github-actions bot commented Mar 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Semver Impact of This PR

New Features ✨

Core

Spring

Other

Bug Fixes 🐛

Uh oh!

github-actions bot commented Mar 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

sentry bot commented Mar 9, 2026

Sentry Build Distribution

Uh oh!

github-actions bot commented Mar 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Performance metrics 🚀

Baseline results on branch: feat/cache-tracing-sample

Startup times

App size

Previous results on branch: feat/cache-tracing-jcache

Startup times

App size

Uh oh!

sentry bot commented Mar 10, 2026

Sentry Build Distribution

Uh oh!

sentry bot commented Mar 10, 2026

Sentry Build Distribution

Uh oh!

sentry bot commented Mar 10, 2026

Sentry Build Distribution

Uh oh!

sentry bot commented Mar 10, 2026

Sentry Build Distribution

Uh oh!

sentry bot commented Mar 10, 2026

Sentry Build Distribution

Uh oh!

sentry bot commented Mar 10, 2026

Sentry Build Distribution

Uh oh!

adinauer commented Mar 10, 2026

Uh oh!

adinauer commented Mar 10, 2026

Uh oh!

adinauer commented Mar 10, 2026

Uh oh!

adinauer commented Mar 10, 2026

Uh oh!

cursor bot left a comment

Choose a reason for hiding this comment

Uh oh!

cursor bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

sentry bot commented Mar 10, 2026

Sentry Build Distribution

Uh oh!

lbloder Mar 16, 2026

Choose a reason for hiding this comment

Uh oh!

adinauer Mar 16, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

adinauer commented Mar 9, 2026 •

edited

Loading

github-actions bot commented Mar 9, 2026 •

edited

Loading

github-actions bot commented Mar 9, 2026 •

edited

Loading

github-actions bot commented Mar 9, 2026 •

edited

Loading